<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">

<HTML>
<HEAD>
   <TITLE>int pblIsamInsert</TITLE>
   <META NAME="GENERATOR" CONTENT="DOC++ 3.4.9">
</HEAD>
 <center>
<H2>Program Base Library Functions</H2>
</center>

<H2>int <A HREF="#DOC.DOCU">pblIsamInsert</A></H2><H2>( <!1><A HREF="pblIsamFile_t.html">pblIsamFile_t</A>*  isamfile,<BR>&nbsp;  unsigned char*  allkeys,   int allkeyslen,<BR>&nbsp;  unsigned char*  data,   long datalen )</H2><BLOCKQUOTE> insert a new record with the given keys and data into the isam file,</BLOCKQUOTE>

<A NAME="DOC.DOCU"></A>
<HR>
<H2>Documentation</H2>
<BLOCKQUOTE>
insert a new record with the given keys and data into the isam file,

<P>the current record of the file will be set to the new record

<P><P>
<B>RESTRICTIONS</B>:
<BR> - the file must be open for update,
<BR> - allkeys must point to the keys to be inserted,
<BR> - allkeyslen must be bigger than 0 and smaller than 1024,
<BR> - data must point to the data be inserted,
<BR> - datalen must not be negative,
<BR> - if datalen == 0, the pointer data is not evaluated at all

<P>Parameter <I>allkeys</I> must contain all values for all keys
of the record. The values have to be prepended by one byte giving
the length of the following value. All values have to be concatenated
into one string.

<P>Example:
<PRE> 4isam4file3key </PRE>
with the numbers as binary values and the letters ascii,
specifies three keys with the values "isam", "file" and "key".

<P></BLOCKQUOTE>
<DL><DT><DT><B>Parameters:</B><DD><B>isamfile</B> -   ISAM file to insert to                    
<BR><B>allkeys</B> -   pointers to all keys to insert            
<BR><B>allkeyslen</B> -   total length of all keys to insert        
<BR><B>data</B> -   data to insert                            
<BR><B>datalen</B> -   length of the data                        <BR><DT><B>Returns:</B><DD>  int rc == 0: call went ok
<BR>  int rc != 0: some error occured, see pbl_errno
<BR><DD></DL><P><P><I><A HREF="index.html">Alphabetic index</A></I></P><HR>
<BR>
This page was generated with the help of <A HREF="http://docpp.sourceforge.net">DOC++</A>.
</BODY>
</HTML>
